feat: hosted remote log relay for production debugging by NisargIO · Pull Request #3 · millionco/debug-agent

NisargIO · 2026-05-16T07:03:24Z

Summary

Adds @debug-agent/remote, a Cloudflare Worker + SQLite-backed Durable Object that acts as a hosted NDJSON log relay so production code (no localhost) can push logs to a public URL and the local agent can read them back.
Adds a debug-agent remote CLI subcommand (--daemon, --json, interactive) that creates sessions on the Worker and streams logs over SSE parsed from fetch() (no EventSource dep).
Updates SKILL.md with a local-vs-remote decision section and remote variants of STEP 0 / STEP 2 / STEP 4 plus a remote API reference table.
Drops .wrangler and .dev.vars* into .gitignore. Incidental formatter cleanup on debug-agent-browser lives in its own commit.

Worker design

POST /sessions → returns { sessionId, endpoint, streamUrl, expiresAt } using a 21-char nanoid.
LogSession Durable Object schedules an alarm at Date.now() + 3_600_000; the alarm handler broadcasts an expired SSE event, closes writers, and calls ctx.storage.deleteAll() (compatibility date 2026-02-24 so the alarm is cleared in the same call).
Storage caps enforced on every POST with 413 Payload Too Large: max 10K entries, 10KB per entry, 100MB total.
Optional id field on the payload is used for dedup via an indexed entry_id column.
SSE: connected → replay buffered log events → replay-complete → live log events broadcast from POST /s/:id.
Expired or unknown sessions return 410 Gone.
CORS open (*) on every response and OPTIONS * preflight.

Deployed at https://debug-agent-remote.aidenbai.workers.dev.

Test plan

wrangler dev — all routes exercised locally (create, ingest, read NDJSON, SSE replay + live, DELETE, dedup, 413 over-size, 410 unknown, CORS preflight).
wrangler deploy succeeds; live worker passes the same smoke tests.
pnpm build && pnpm test (63/63 tests pass) and pnpm check clean.
debug-agent remote --daemon prints session info and exits.
debug-agent remote --json streams remote logs as NDJSON to stdout.
End-to-end skill workflow validated by debugging a synthetic off-by-one bug entirely through the deployed worker: instrumented HTTP POSTs, fetched logs via curl ENDPOINT, confirmed hypothesis from cited log lines, fixed, re-verified with runId=post-fix logs.

Made with Cursor

Incidental whitespace/formatting cleanup surfaced by `pnpm check --fix` while working on remote logging. No behavioral changes. Co-authored-by: Cursor <cursoragent@cursor.com>

Introduces a hosted log relay so production apps can push NDJSON logs to a public URL and a local debug-agent session can read them back. Solves the problem that `localhost` endpoints don't work for production bugs. - New package `@debug-agent/remote`: Cloudflare Worker with a SQLite-backed Durable Object (`LogSession`). Each session is created by `POST /sessions` (nanoid id), auto-expires after 1 hour via a DO alarm that calls `deleteAll()`, and enforces 10K entries / 10KB per entry / 100MB total limits with `413 Payload Too Large`. Routes: `POST/GET/DELETE /s/:id` and SSE at `GET /s/:id/stream` (replays buffered logs then streams live). Returns `410 Gone` for expired or unknown sessions. CORS open on every response. - New `remote` subcommand in `debug-agent` CLI with `--daemon`, `--json`, and interactive modes. SSE is parsed manually from `fetch()` — no EventSource dep. Default Worker URL is configurable via `--url`. - Updated SKILL.md with a local-vs-remote decision section and remote variants of STEP 0, STEP 2, STEP 4, plus a remote API reference table. Deployed at https://debug-agent-remote.aidenbai.workers.dev and end-to-end verified via the debug-agent skill workflow. Co-authored-by: Cursor <cursoragent@cursor.com>

reactreview · 2026-05-16T07:03:27Z

Copy as prompt

Check if these React Review issues are valid. If so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.

Run this before and after your changes to verify the result:
npx react-doctor@latest --verbose --diff

Do not modify the react-doctor configuration unless explicitly asked.
Fix the underlying code issues instead of changing or suppressing the rules.

React Review found 0 errors and 2 warnings. This PR leaves the React health score unchanged.

<file name="packages/debug-agent-remote/src/log-session.ts">

<violation number="1" location="packages/debug-agent-remote/src/log-session.ts:103">
Severity: Warning

await inside a for…of loop runs the calls sequentially — for independent operations, collect them and use `await Promise.all(items.map(...))` to run them concurrently

Collect the items and use `await Promise.all(items.map(...))` to run independent operations concurrently

Rule: `async-await-in-loop`
</violation>

</file>

<file name="packages/debug-agent/src/utils/parse-sse-stream.ts">

<violation number="1" location="packages/debug-agent/src/utils/parse-sse-stream.ts:22">
Severity: Warning

await inside a while-loop runs the calls sequentially — for independent operations, collect them and use `await Promise.all(items.map(...))` to run them concurrently

Collect the items and use `await Promise.all(items.map(...))` to run independent operations concurrently

Rule: `async-await-in-loop`
</violation>

</file>

^{Reviewed by reactreview for commit c3dc996. Configure here.}

vercel · 2026-05-16T07:03:29Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
debug-agent-website	Ready	Preview, Comment	May 25, 2026 2:20am

vercel · 2026-05-16T07:11:34Z

+
+        newlineIndex = buffer.indexOf("\n");
+      }
+    }


SSE stream parser loses buffered data when stream ends without a terminating blank line (refactored version with eventsource-parser)

- Added eventsource-parser as a dependency in debug-agent package. - Refactored SSE stream parsing in parse-sse-stream.ts to utilize eventsource-parser for improved event handling. - Updated pnpm-lock.yaml to include eventsource-parser version 3.0.8. This change enhances the efficiency and reliability of server-sent event parsing.

NisargIO and others added 3 commits May 15, 2026 23:01

fix: live url plan

8468ffe

style: apply formatter to debug-agent-browser

c4b2a6b

Incidental whitespace/formatting cleanup surfaced by `pnpm check --fix` while working on remote logging. No behavioral changes. Co-authored-by: Cursor <cursoragent@cursor.com>

vercel Bot deployed to Preview May 16, 2026 07:03 View deployment

vercel Bot reviewed May 16, 2026

View reviewed changes

vercel Bot deployed to Preview May 25, 2026 02:20 View deployment

aidenybai merged commit b47aab7 into main May 25, 2026
9 checks passed

aidenybai deleted the live-urls branch May 25, 2026 04:10

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: hosted remote log relay for production debugging#3

feat: hosted remote log relay for production debugging#3
aidenybai merged 4 commits into
mainfrom
live-urls

NisargIO commented May 16, 2026

Uh oh!

reactreview Bot commented May 16, 2026 •

edited

Loading

Uh oh!

vercel Bot commented May 16, 2026 •

edited

Loading

Uh oh!

Uh oh!

vercel Bot May 16, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

NisargIO commented May 16, 2026

Summary

Worker design

Test plan

Uh oh!

reactreview Bot commented May 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

vercel Bot commented May 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

vercel Bot May 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

reactreview Bot commented May 16, 2026 •

edited

Loading

vercel Bot commented May 16, 2026 •

edited

Loading

vercel Bot May 16, 2026 •

edited

Loading